home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1995 April / Internet Tools.iso / infoserv / gopher / Macintosh-TurboGopher / TurboGopherVR / TurboGopherVR2.1a2.sea.hqx / TurboGopherVR 2.1a2 folder / TurboGopherVR 2.1a2.rsrc / TEXT_129_HeLp.txt < prev    next >
Encoding:
Text File  |  1995-03-31  |  24.2 KB  |  532 lines

  1. ======      How to Navigate TurboGopherVR scenes      ======
  2.  
  3. You can either use the mouse or the arrow keys to drive around the
  4. 3D scenes. 
  5.  
  6. To use the mouse, hold down the mouse button and drag up or down to
  7. change your position. To turn your head, drag left or right. The
  8. arrow keys do what you expect... the up arrow move you in, the down
  9. arrow moves you back, the left and right arrow keys turns your
  10. head. Holding down the shift key while using the arrow keys
  11. constrains the motion (i.e. moves you more slowly).
  12.  
  13. If you get lost, you can always get back to the starting point by
  14. selecting the "Initial viewpoint" command from the "VR" menu
  15.  
  16. To select an object (i.e. to open it) click on the object once with
  17. the mouse. Clicking on the red "kiosk" in the center of the scene
  18. moves you back to the previous gopher directory.
  19.  
  20. You can twirl the scene by holding down the option key and using
  21. the left or right arrow keys. Holding down both the option with
  22. the shift key again constrains the motion (the scene twirls more
  23. slowly). If you prefer using the mouse, you can twirl the scene by
  24. holding down the opetion key and dragging left or right with the
  25. mouse button held down.
  26.  
  27. To get information about an object, hold down the control key and
  28. click on the object. This will display a popup containing the
  29. object's name, type, abstract (if available), and other
  30. meta-information. This is very useful if you want to find out about
  31. an object without driving over to it.
  32.  
  33. You can jump around the scene with commands found under the "VR"
  34. menu. I hope you can guess what the "Jump forward" command does.
  35. The "Jump in place" command is used to jump up into the air while
  36. looking forward. This is useful if you want to see what is ahead of
  37. you. The "Overview" command is used to see the neightbohood around
  38. you. It works a lot like riding on a swing... the higher you get
  39. the more you look toward the ground.
  40.  
  41. The mouse can be used to issue the jump commands. If you click on
  42. the sky or the ground you will jump forward. To get an overview of
  43. the neighborhood, hold down the shift key while clicking on the sky
  44. or ground. To jump in place, hold down the shift and option keys
  45. while clicking.
  46.  
  47. Whenever a new directory is fetched while the GopherspaceVR window
  48. is open, the Gopherspace VR window is updated. If you don't want to
  49. look at GopherspaceVR, close the GopherspaceVR window. 
  50.  
  51. If you have configured TurboGopher so that it does not connect to a
  52. gopher server at startup, you will see a demo scene. This scene is
  53. also displayed if you have closed and then re-opened the
  54. GopherspaceVR window. You can drive around the demo scene and click
  55. on things, but since this scene isn't connected to information on a
  56. gopher server, you can't move to other scenes. To get out of this
  57. demo mode, you can click on an folder or search item in a gopher
  58. browser window. 
  59.  
  60. Note that the gopher browser windows stack up on top of each other. 
  61. You can free memory by closing them.
  62.  
  63.  
  64.  
  65. ======      WARNING      ======      
  66.  
  67. This is a sneak-preview alpha test release. I wouldn't distribute it
  68. to every user in my organization just yet since
  69.  
  70.   1.) There are a lot more features that will be added in 
  71.       the near future.
  72.       
  73.   2.) There are certainly going to be bugs.
  74.   
  75. If you find a bug, please report it to us by sending an e-mail
  76. decribing your computer, the version of the operating system and
  77. how you caused the bug to occur. If you have idea for features we'd 
  78. love to hear about it. Send your bug reports and comments to:
  79.  
  80.      <gopher@boombox.micro.umn.edu>. 
  81.     
  82.     
  83.  
  84. ======      Definitions      ======
  85.  
  86.     Gopher  n.  1. Any of various short tailed, burrowing mammals of the
  87.     family Geomyidae, of North America.  2. (Amer. colloq.) Native or
  88.     inhabitant of Minnesota: the Gopher State.   3.  (Amer. colloq.) One
  89.     who runs errands, does odd-jobs, fetches or delivers documents for
  90.     office staff.  4. (Computer tech.) software following a simple
  91.     protocol for burrowing through a TCP/IP internet.
  92.  
  93.     Gopher+  n.  1. Hardier strains of mammals of the family 
  94.     Geomyidae.  2. (Amer. colloq.) Native or inhabitant of Minnesota, 
  95.     the Gopher state, in full winter regalia (see PARKA).  3. (Amer. 
  96.     colloq.) Executive secretary.  4. (computer tech.) Software 
  97.     following a simple protocol for burrowing through a TCP/IP 
  98.     internet, made more powerful by simple enhancements 
  99.     (see CREEPING FEATURISM).
  100.  
  101.     TurboGopher  n.  1. A small rodent with a turbocharger strapped on
  102.     its back to increase its speed and ferocity.  2. (Amer. colloq.)
  103.     Native or inhabitant of Minnesota after consuming three double
  104.     espressos. 3. (Amer. colloq.) An Olympic sprinter who runs errands,
  105.     does odd-jobs, fetches or delivers documents for office staff.  4.
  106.     (computer tech.) Speed-optimized Macintosh software following a
  107.     simple protocol for burrowing through a TCP/IP internet; network
  108.     speed is achieved by using turbocharged software; incoming bits spin
  109.     the turbine that pumps out the outgoing bits.
  110.  
  111.  
  112. ======      Overview      ======
  113.  
  114. TurboGopher is a Macintosh application that we believe is (still!)
  115. the fastest Macintosh Gopher client available. Beyond optimizing 
  116. TurboGopher for raw speed while fetching documents and directories,
  117. we turbocharged the user interface by displaying information as
  118. soon as possible... you can read the first part of a document or
  119. directory while the rest is being fetched. You can fetch multiple
  120. documents or directories at the same time.  TurboGopher also
  121. supports the Gopher+ extensions to the original Internet Gopher
  122. protocol.  TurboGopher runs in native mode on both 68K Macs and
  123. on Power Macs.
  124.  
  125. In spite of the design goal to run fast as possible, TurboGopher is
  126. a good Mac citizen: it shares time with other applications. You
  127. can put TurboGopher in the background to fetch lengthy items in the
  128. background while you work in another application in the foreground.
  129. You can even use TurboGopher to download entire directories of 
  130. Mac software with a single command.
  131.  
  132. TurboGopher is copyright ┬⌐ 1991-1995 by the University of Minnesota.
  133.  
  134.  
  135. ======      What is Gopher?      ======
  136.  
  137. The Internet Gopher protocol and the first Gopher software was 
  138. developed by the Gopher Team at the University of Minnesota. Gopher
  139. was originally created as a fast, simple, distributed, campus-wide
  140. information search and retrieval system. A worldwide network of
  141. Gopher servers now exists; this network of Gopher servers is at
  142. your service from a Mac, PC, or workstation connected to the
  143. Internet. Gopher clients can also access non-gopher based services
  144. to seamlessly access a variety of non-Gopher services such as FTP, 
  145.  Archie, WAIS, USENET news, www, whois servers, etc. either via
  146. gateway servers or by using Helper Applications.
  147.  
  148. The Gopher software may be retrieved from numerous Gopher or FTP 
  149. archive sites, including the University of Minnesota Gopher server,
  150. the Merit Software Archive Gopher server, and by anonymous FTP
  151. from boombox.micro.umn.edu and sumex-aim.stanford.edu. The most
  152. recent release of TurboGopher is always available from the
  153. University of Minnesota Gopher server (or by anonymous ftp from
  154. boombox.micro.umn.edu). If you discover a bug, you might check
  155. to see if you have the newest version of TurboGopher; perhaps
  156. the bug has been fixed. The version number of your TurboGopher
  157. may be found clicking on the application's icon in Finder and
  158. choosing 'Get Info' from the Finder's File menu.
  159.  
  160.  
  161. ======      How does it work?      ======
  162.  
  163. Information accessible via Gopher is stored on many computers all
  164. over the Internet. These computers are called Gopher servers.
  165. Information stored on many kinds of non-gopher servers is also
  166. available via special gopher servers that act as gateways
  167. (protocol translators). Virtually any popular computer (Mac, Unix
  168. box, PC, or larger computer) can be used as a server. Servers do
  169. not just contain files, directories and searchable databases; they
  170. can also contain references to other servers. To retrieve and
  171. search this information, you need to run a Gopher client
  172. application on your computer. TurboGopher is a Gopher client
  173. application. You can set it up to remember how to connect to one
  174. server; from here you can effortlessly traverse the network of all
  175. interlinked servers.
  176.  
  177.  
  178. ======      Using TurboGopher      ======
  179.  
  180. TurboGopher now requires the use of System 7; sorry about that.
  181. TurboGopher now also requires the use of the Thread Manager
  182. extension.  Thread Manager is licensed from Apple Computer Inc. by
  183. the University of Minnesota and is available with the TurboGopher
  184. distribution  You should drop the Thread Manager extension into
  185. your Extensions folder (if you are running a system older than 7.5)
  186. and restart your Mac. Thread Manager is part of System 7.5
  187. (and newer systems).
  188.  
  189. TurboGopher uses MacTCP to communicate with gopher servers on a 
  190. network. Assuming your Mac has correctly configured MacTCP software 
  191. installed in the System Folder, TurboGopher is all set to go.
  192.  
  193. In addition since TurboGopher makes extensive use of other applications
  194. (Helper Applications... for example to fetch items via FTP or to
  195. render GIF or html items), we suggest that you install our recommended
  196. suite of Helper applications on your hard disk.  The suite is
  197. available with the TurboGopher distribution from boombox.micro.umn.edu
  198. (by ftp or by gopher).
  199.  
  200.  
  201. ======  Converting your old (version 1.x) Bookmark files  ======
  202.  
  203. If you have not already saved the TurboGopher 1.x bookmarks in
  204. your bookmark window to a file, select the bookmark window and
  205. choose 'Save As a Bookmark File' from the File menu.  Now quit from
  206. the old TurboGopher and launch TurboGopher 2.0. Select Open from
  207. the File menu while holding down the Option key. You will be able
  208. to select your old Bookmark file and it will be converted to the
  209. new format. You'll have a chance to save in the new format.
  210.  
  211. Remember, with TurboGopher 2.0 you can cut-copy and paste any gopher
  212. items between list windows.
  213.  
  214.  
  215. ======      Navigating Gopherspace      ======
  216.  
  217. To navigate through gopherspace, double-click on any interesting
  218. items to open (fetch) them. If you double-click on a file,
  219. TurboGopher will fetch and display the file. Opening a folder will
  220. let you view its contents. Double-clicking on the question-mark
  221. (Search) icons will let you search a database. On most gopher
  222. servers these databases are full-text indexes of a collection of
  223. information. Full-text index means that every word in every 
  224. document is considered a keyword. The best way to search a gopher
  225. full-text database is specify the words for which to search when
  226. TurboGopher presents you with a dialog box. The results of the
  227. search are returned as a list of documents containing those words.
  228.  
  229. If you double-click on the phone-book icons TurboGopher will launch
  230. the Ph application with which you can search electronic phone
  231. books. Phone book databases are structured in the sense that they
  232. have fields (i.e. a name field, an address field, and a phone
  233. number  field). Of course you need to have Ph on your Mac's hard
  234. disk.
  235.  
  236. Disk icons represent archived Mac software or documents that you can
  237. fetch; these items will be saved to your hard disk. Such items are
  238. often stored in compressed form to save space. You need to have
  239. Mac utilities to 'uncompress' such items.  We recommend
  240. StuffIt Expander which can deal with virtually all the kinds of
  241. archives you may encounter.  StuffIt Expander can be found on
  242. the UMich archive and also in the TurboGopher helper applications
  243. directory on boombox.micro.umn.edu.
  244.  
  245. Items that are specific to MS-DOS are seen as documents with a tiny 
  246. 'PC' emblazoned on them; similarly items specific to UNIX show up
  247. as  documents with a tiny 'UX' on them. You can retrieve either of
  248. these  kinds of items if you like. TurboGopher will ask you if you
  249. wish to save  them to your disk. You may not 'view' these items as
  250. text. In fact it  will probably make very little sense to fetch
  251. such items unless you intend  to further transfer them later from
  252. your Mac to another kind of computer, or if you have some special
  253. tools on your Mac that will allow you to use  these kinds of items.
  254.  
  255. Items appearing as documents with a starburst on them are probably 
  256. graphics or picture files (typically in GIF, JPEG, or PICT format). 
  257. TurboGopher will transfer such files, save them on your disk, and 
  258. optionally launch a picture-viewing helper application if you wish
  259. to view the picture.  We recommend JPEGView.
  260.  
  261. Items with an 'h' in the icon are html files. TurboGopher will fetch
  262. such files and then pass them to an application capable of displaying
  263. html, such as MacWeb.
  264.  
  265.  
  266. ======      Connecting to terminal-based services      ======
  267.  
  268. Opening the 'terminal' icons will make TurboGopher launch NCSA 
  269. Telnet (or TN3270 if appropriate) and start a terminal session to a
  270. terminal-based information system. Typically these are library
  271. catalogs or other such services. Note that for this to work you
  272. need to have Telnet or TN3270 installed on your Macintosh. 
  273.  
  274.  
  275. ======      Alternate Views      ======
  276.  
  277. Gopher+ servers may store more than one representation of a document
  278. (an image, text, sound, video, etc. ). If more than one view of a
  279. document is available, you can select between the views by
  280. choosing the 'Get Alternate Views' item from the Gopher menu. When
  281. alternate views are available, an alternate view window will be
  282. displayed with descriptions of the views.
  283.  
  284. For many alternate views of documents, TurboGopher will save a copy
  285. of the item to your Macintosh's disk, and then (under System 7)
  286. optionally ask the Finder to open the item with a helper
  287. application. You can configure which applications should be used
  288. as TurboGopher helpers; to do this see the section on
  289. configuration options.
  290.  
  291.  
  292. ======      Bookmarks      ======
  293.  
  294. If you formulate a search or find a folder you would like to come back to 
  295. quickly later, you can save the entire list window to your Mac hard disk. 
  296. with the Save AsΓǪ menu item. You may also cut and paste items in list
  297. windows using standard Mac Cut-Copy-Paste. This allows you to rearrange
  298. items in any window.  We call cut-copied-pasted items Bookmarks because
  299. you are not really dealing with the actual item... you are just saving a link
  300. (or pointer or reference) to the item's location. The actual item stays on 
  301. the server, and indeed may change contents between two successive times
  302. you fetch it.
  303.  
  304. There is a special window called the Bookmark Worksheet window that 
  305. is intended to be a kind of "construction area" for you to
  306. build your own scratch-pad of useful gopher resources. You can show and
  307. hide this window. Its contents are automatically saved in a file called
  308. Bookmark Worksheet in the same directory as the TurboGopher application.
  309.  
  310. You may edit the names or other parts of bookmarks using the Edit
  311. Gopher DescriptorΓǪ menu item. Unless you understand the Gopher protocol we
  312. don't recommend that you change anything except perhaps the title (name)
  313. of a Bookmark.
  314.  
  315. If you connect to a new gopher server and you wish to save a reference
  316. to the server, deselect all the items in the window (click after the 
  317. last item in the window), then choose Copy from the Edit menu.  Now
  318. you can Paste as you would any other bookmark.
  319.  
  320.  
  321. ======      Advanced Navigation Features  & Shortcuts    ======
  322.  
  323. You may use the up and down arrow keys on your keyboard to move up 
  324. and down lists in windows. The Enter or Return key opens an item (and is 
  325. equivalent to double-clicking on an item). Use of the arrow keys
  326. is not supported on the Mac Plus.... (sorry).
  327.  
  328. If you select more than one item (eg. via Select All or by
  329. Shift-Clicking an extended selection) and hit the Enter key
  330. TurboGopher will fetch ALL the items you have selected.  It will
  331. attempt to do this in as safe and respectful manner as possible
  332. both for you and for the server. To achieve this it will keep
  333. concurrent requests to a small minimum.  You shouldn't run out of
  334. memory or processing power and the server shouldn't feel
  335. overwhelmed either.  If you have a bunch of files selected
  336. that must be downloaded to your Mac, we suggest that you use 
  337. the Preferences menu item to select a default download directory
  338. (otherwise you will be plagued with a series of standard "Save File"
  339. dialogs).
  340.  
  341. You may also type the first letter (or first few letters) of an item
  342. name in a list and TurboGopher will highlight the first item it
  343. finds that matches (like the Finder does in list views). The Find
  344. menu item is available to locate an item in a list: just type a
  345. string in the Find dialog. Find can also be used to search for
  346. text in open document windows (such as this Help document).
  347.  
  348. To delete any item in any list window, click once on the item to
  349. select it, then hit the Delete key much as you would to delete any
  350. item on a Mac.
  351.  
  352. The Recent menu lets you go back to any document or directory
  353. window you have viewed during your Gopher session.
  354. The Recent list remembers the last 50 items you visit.
  355.  
  356. Pressing the escape key in a window causes TurboGopher to release
  357. the contents of a window and re-fetch the contents.
  358.  
  359. If you click in the close box of a window while holding down the Shift key,
  360. the window will be closed will also be removed from the Recent menu.
  361. If you click in the close box while holding down the Option key, the window
  362. will be closed, and so will all the other windows. Of course if you hold
  363. down the Option AND Shift keys all the windows will be closed AND forgotten.
  364.  
  365. If you hold down the Option key while Double clicking on an item
  366. in a list, TurboGopher will close the parent window after opening
  367. the window for the selected item.
  368.  
  369. For the power user, if you hold down the Control key while SINGLE
  370. clicking on an item in a list, TurboGopher will display the item's 
  371. Uniform Resource Locator (URL) as well as the Gopher selector
  372. string, host name, port number and Gopher+ baggage. This is a quick
  373. peek. If you want to copy-paste this information, use the Get
  374. Attribute Info menu item found under the Gopher menu.  There is also
  375. a power user way to copy a URL: hold down the Option key while
  376. selecting Copy from the Edit menu.
  377.  
  378.  
  379. ======      Item Attributes      ======
  380.  
  381. Modern Gopher servers (referred to as Gopher+ servers)
  382. can provide you with information about any selected item, much like
  383. the Finder's Get Info menu lets you get information about a Mac item.
  384.  
  385. Use the 'Get Attribute Info' menu item of the Gopher menu for this.
  386.  
  387.  
  388. ======      Canceling Slow Network Operations      ======
  389.  
  390. TurboGopher executes most requests in a few seconds. A document or 
  391. directory is displayed as it is received. However, if a server is 
  392. especially slow or busy or if you have started to fetch what appears 
  393. to be a very long and uninteresting document or directory, you may 
  394. cancel the fetching process by holding down the Command key and
  395. typing the period (Command-.) or by closing the document or directory 
  396. window. Once you have closed the window, TurboGopher assumes that it 
  397. does not need to fetch the remainder of the item. Note that when you 
  398. fetch a file that is saved to your Mac disk, TurboGopher displays a 
  399. window with the status of the transaction. Again, to cancel, just
  400. close the window.
  401.  
  402. TurboGopher runs happily in the background (so you can fetch 
  403. something very large or from a very slow server while you do something
  404. else in another application in the foreground). You may also fetch an 
  405. item (file or directory) while another one is still being fetched, since 
  406. TurboGopher supports multiple concurrent streams.
  407.  
  408.  
  409. ======      Starting and Configuring TurboGopher      ======
  410.  
  411. The 'Home Gopher' item under the Gopher menu opens a window
  412. containing the initial directory fetched by connecting to your
  413. home Gopher server. You may change your home Gopher server by
  414. using the 'Preferences' item under the Gopher menu. To do this you
  415. need the full Internet domain name and port of the desired primary
  416. server.
  417.  
  418.  
  419. ======      TurboGopher Preferences    ======
  420.  
  421. You may change the font and style for any document or list window
  422. using the Format menu. The Preferences menu item also lets you
  423. change the default font and style (used for all new documents or lists).
  424. Following the Macintosh guidelines, TurboGopher starts out displaying
  425. text in the standard application font.
  426.  
  427. With Gopher+ servers, items may be available in a number of
  428. alternate views. When fetched, these alternate views are typically
  429. saved as a file to be viewed by a Mac application. If you are a
  430. network/macintosh cowboy, you can also change the Mac application
  431. and Mac filetype associated with a Gopher+ alternate view....
  432. (this changes the helper application that TurboGopher asks the
  433. finder to launch to view the document) via the Preferences menu. 
  434. Double-click the view in the list and you will be presented with a
  435. dialog in which you can select the application to be used as a 
  436. TurboGopher helper.
  437.  
  438. There are two helper applications that you might want to change to
  439. suit your needs.
  440.  
  441. The first is the application that deals with BinHexed items
  442. (Mac software and documents) downloaded from servers.
  443. The line specifying this starts with simply "BinHex".
  444. This helper is initially set to point back to TurboGopher.  We
  445. think it might be a good idea to point it at StuffIt Expander 
  446. instead.  If you do this, all incoming BinHexed files will be 
  447. saved (raw) in a form that StuffIt Expander can process.
  448.  
  449. The second helper is the one that deals with plain text.
  450. The line specifying this starts with the word "Text".
  451. This helper is also initially set to point back to TurboGopher.
  452. So when you save text files from TurboGopher, they are saved as
  453. TurboGopher files.  Since TurboGopher has a fast editor within
  454. it, and it can view huge files we don't recommend changing this
  455. (SimpleText only handles 32K of text and it is much slower).
  456. However if you have a favorite text editor and want your files
  457. to be saved for this editor, change the Text helper application.
  458. For heaven's sake don't use Messy Word.... 
  459.  
  460. If you choose a default Download Folder via Preferences, TurboGopher
  461. will save all downloaded items into this folder without putting up
  462. a standard Save File dialog.  We strongly recommend that you do this.
  463.  
  464.  
  465. ======      Miscellaneous      ======
  466.  
  467. TurboGopher saves or caches the item lists for all visited directories
  468. (even when windows are closed). Since these lists shouldn't have to be
  469. fetched from the server again, this dramatically increases speed when
  470. choosing any item from the Recent menu.  Under certain circumstances
  471. these cached items are released... and choosing them from the Recent
  472. menu now will make TurboGopher re-fetch them (it will just take a little
  473. longer if this happens).
  474.  
  475. TurboGopher stores what it needs in a file called TurboGopher Preferences; 
  476. this lives in the Preferences folder, which is found in your System Folder.
  477.  
  478. TurboGopher is very content to live in the default memory partition we
  479. allocate for it (around 700K).  We cannot think of many reasons to
  480. give it more memory.
  481.  
  482. ======     Known Bugs      ======
  483.  
  484. Window width not dynamic.
  485. There are screen update problems under certain conditions.
  486.  
  487.  
  488. ======      Incomplete features      ======
  489.  
  490. Command-Click on title bar.
  491. Drag Items from window to window or to the desktop.
  492.  
  493.  
  494. ======      For Experts      ======
  495.  
  496. You may send e-mail to the Gopher Team at:
  497.  
  498.              gopher@boombox.micro.umn.edu
  499.  
  500. to report bugs, make suggestions, or (of course!) bestow praise. To
  501. be informed by e-mail of new developments in the Gopher world, or
  502. of new versions of Gopher software, you may subscribe to the
  503. 'gopher-announce' mailing list; Send your request to:
  504.  
  505.        gopher-announce-request@boombox.micro.umn.edu. 
  506.  
  507. Have fun surfing the Internet...
  508.  
  509. - The Internet Gopher Team at the University of Minnesota    
  510.  
  511.  
  512.  
  513. -------------------------------------------------
  514. ...and now, to keep the lawyers happy...
  515.  
  516. The TurboGopher software and documentation is copyright ┬⌐ 1991 - 1995
  517. by the University of Minnesota.
  518.  
  519. Permission to use, copy, modify, and distribute this software and
  520. documentation for non-commercial purposes and without fee is hereby
  521. granted, provided that the University of Minnesota copyright notices and
  522. this permission notice appear in all copies, and that the name
  523. University of Minnesota not be used in advertising or publicity
  524. pertaining to this software and documentation without specific, written
  525. prior permission. The University of Minnesota makes no representations
  526. about the suitability of this software and documentation for any
  527. purpose.  It is provided 'as is' without express or implied warranty. 
  528.  
  529. Commercial use of TurboGopher requires specific permission from the
  530. University of Minnesota; contact the Internet gopher development team at
  531. gopher@boombox.micro.umn.edu for further information.  
  532. -------------------------------------------------